Release 10.1A: OpenEdge Application Server:
Developing AppServer Applications

Connecting using HTTP

The HTTP protocol specifies that OpenEdge use HTTP to connect the client to the AppServer indirectly, through a Web server running the AppServer Internet Adapter.

This is the URL syntax to connect an AppServer (or BrokerConnect) using HTTP (ignore line breaks):

Syntax

http://[user-id[:password]@]web-server-host[:web-server-port] /aia-path[?AppService=service-name]

user-id

User account name to use to connect to a Web server that hosts the AIA.

password

Password to use with user-id.

web-server-host

TCP/IP host address or host name of the Web server that hosts the AIA.

web-server-port

TCP/IP port address of the Web server that hosts the AIA. The default is 80 for HTTP and 443 for HTTPS.

aia-path

URL path on the Web server where the AIA is installed. The aia-path identifies the virtual path and servlet name used to invoke the JSE and AIA. It must include the following information:

A virtual path the JSE has configured within the Web server to recognize and pass directly to the JSE, instead of looking for that directory on the Web server.
Name of the Java servlet to be invoked by the JSE.

The specification of the path depends on your Web server, JSE, and AIA configuration. For more information, see the sections on AIA administration in OpenEdge Application Server: Administration and the documentation for your Web server and servlet engine.

service-name

Name of the application service (AppServer or BrokerConnect). The service-name identifies the application service to which the AIA connects. If you do not specify an application service for a NameServer, the AIA uses the default application service registered with NameServer to complete the connection. If the AIA is configured to access the AppServer directly, you have no need to specify an application service at all.

The following are examples of the AppServer URL format, where external/aia1 is the path to the AIA:

http://aia.acme.com/external/aia1?AppService=Partners http://aia.acme.com:2045/external/aia1?AppService=Partners http://jones@aia.acme.com/external/aia1?AppService=Partners http://jones:brownie@aia.acme.com/external/aia1?AppService=Partners